home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-11
/
prohp5.zip
/
READ.ME
< prev
next >
Wrap
Text File
|
1993-02-10
|
23KB
|
713 lines
=====================================================================
NO COMPILING TO RUN THIS DEMO, TYPE DEMO <ENTER> AND OUTPUT DIRECTLY
TO YOUR LASER PRINTER.
=====================================================================
This read.me file does not print as part of the demo.
ProHP Version 5.4 ( Release date Feb.15, 1993 )
Fully compatible with Clipper 5.x and up.
Version 5.4 adds to PCL 5 support, and includes HP GL vector
graphics, PCX printing, automatic word wrapping, full justification,
and use of scalable fonts.
+*******************************************************************+
| ProHP is a cutting edge library for |
| Laser Printer control |
+*******************************************************************+
ProHP is unlike any other library you have ever used. It goes beyond
being just a function call library. Many functions will automatically
adjust what you are printing. We have listened to Clipper programmers
from all over the world who were not satisfied with business as usual
libraries. The result: The ProHP system of laser printer control.
Instead of making separate calls each time you want to set a print
parameter, ProHP allows you to set the print environment up front.
Then if you decide to change a font style etc., do it once, and ProHP
AUTOMATICALLY adjusts to give you professional looking results. After
all, what does your client see? Most clients have no idea of the
effort you have expended, but they do see the laser printed reports,
invoices, charts, graphs and letters.
When you have good looking and innovative hard copy, with sharp
Logo's, effective use of shading and other highlights, clients remember
you. Many Clipper programmers are winning repeat business just because
the client loved the printed material. Remember, when you can enhance
what the majority of the business world is used to looking at, your
value and the value of what you do goes up.
ProHP's flexibility and ease of use gives you accurate and
professional results every time. You don't need to hassle with
learning or inserting laser printer code.
DEMO.BAT will print several examples of ProHP capabilities, and a list
of the functions. After printing, take a look at the program code and
see how ProHP can best work for you.
ProHP is the most extensive laser printer control library on the
market. Over 150 functions and 40+ sample programs come with the
library.
The extensive sample programs combine ProHPs functions to show you
how the source code is generally used. These samples are specific
detailed examples that you may use and modify. We have found that
these samples cover most programmers requirements.
Each copy of ProHP includes a free dedicated Expert Help Norton Guide
engine.
This demo contains several programs that you can not compile
without the library, however we included the output in files with
the same name but with extension '.HPC' .
We hope you enjoy this tour. It's only the "Tip Of The Iceberg"!
Call today and order a copy. We are so confident you will love this
program, that we are willing to let you try it for a full 60 days, at
no risk to you. If at the end of that time, you are not convinced
that ProHP does everything you need, send it back, we'll refund your
money..No questions.
ProHP tm developed by I.L.A., Inc., Florida.
(c) Copyright 1992 I.L.A., Inc. All rights reserved.
+=================================================+
| No-Risk |
| 60 Day Money Back Guarantee |
| Free upgrades during the first 90 days |
| Unlimited 24 hour support by fax for 6 months |
+=================================================+
Pricing:
ProHP - Version 5.4 Library US$ 199.00
Add shipping charges
Europe US$ 22.00 (Air Mail)
US$ 30.00 (Int. Express Air Mail)
US$ 45.00 (Fed-X)
USA US$ 8.50 (Priority Air Mail 2 days/UPS ground )
US$ 27.50 (Fed-X next day)
COD CHARGE $ 5.00 (US Only)
Canada US$ 10.50 (Air Mail)
US$ 25.00 (Int. Express Air Mail)
US$ 55.00 (Fed-X)
Australia US$ 21.00 (Air Mail)
US$ 30.00 (Int.Express Air Mail)
US$ 50.00 (Fed-X)
We accept VISA, MASTERCARD. (Purchase orders from government or state
agencies and Fortune 1000 companies.)
To order: Call 1-800-374-7734 (US/ Canada) 9am-5pm EST
International Call: 1 (407) 774-7734
FAX : 1 (407) 774-6750 (24hrs)
Message via CompuServe to David Salvadorini [70712,3072]
+*********************************************+
Customer Support
I.L.A., Inc.
520 W. Hwy 436 #1180
Altamonte Springs, FL 32714
Tel. (407) 774-7734
Fax. (407) 774-6750
CIS: Zion Nefesh 70712,3072
+*********************************************+
ProHP - Function Summary
-------------------------
HP_aatsay( nTop, nLeft, aCstr [,nInc [,cJust]])
Prints an array of text. Left, center or right justify, starting
at any location on the page, using any font.
HP_atsay( [nTop] , [nLeft],cStr[,lRel])
Prints text anywhere on the page. Specify absolute or relative
coordinates. You can specify measurements and use row/col, inches or
centimeters after setting HPsizes().
HP_bar( nHeight, nWidth [,nFill [,nGrayPat]] )
Draw a bar at the current cursor position. By changing the size
of nHeight and nWidth you can draw Horizontal bars, vertical
bars and rectangles (up to full page size). HP_bar() uses gray
shades and patterns.
HP_box( nTop, nLeft, nHeight, nWidth [,nLineWidth [,nFill at]]])
Draw boxes and control line width, line type and shadow.
HP_center(nTop, nLeft, cStr [,nWidth])
Center text in a column or over a point. Precise placement of text!
HP_callmac(nMid)
Call a previously defined macro.
HP_clrmrg()
Clear the printer horizontal margins.
HP_cols( nCols )
Sets the number of columns per inch.
HP_copies(nCopies)
Use this command before the print job. Change the number
of copies any time you desire. The last setting of nCopies is in
effect until the next printer reset.
HP_data(nIndex, Value)
HP_data() used to exchange data between the
functions.
HP_diagtext(nTop,nLeft ,cStr [,nIncTop [,nIncLeft [,lRel] ] ] )
Print text diagonally, at any angle.
HP_endmacro( [nMacroId], [nStat] )
Close a macro definition.
HP_envelope( nEnvType )
Set the printer for envelope printing.
HP_execmacro( nMid )
Execute a macro.
HP_feed( [nFeed] )
Select source of input, paper or envelope. Upper/Lower Tray,
manual or envelope feeder.
HP_fillbox( nTop, nLeft, nHeight, nWidth [,nLineWidth [,nFillBox
[,nGrayPat]]] )
Allows you to draw different types of filled boxes and
control line width, fill type and shadow.
HP_font( cFont [,nAction [,nFontID ] ] )
ProHP is smart. ProHP learns the soft font loaded and adjusts
its environment to fit the use of the selected font.
HP_fontctrl( [nFontID] , nCtrl )
Helps you control the font downloaded to the printer. If
your printer memory has limited space and you need to optimize
the use of fonts, this helps you remove specific fonts and allow
space for new ones.
HP_hline( nTop, nLeft, nLength [,nLineWidth [,nFill [,nGrayPat]]] )
Draw a horizontal line.
HP_hmi( nHmi )
Fixed spacing fonts are affected by HMI change. When
proportional fonts are used, only the space character is
affected. The default HMI is set to the pitch value in the font
header.
HP_init()
HP_init() resets HP_data() array to its default.
HP_lmset( nLm )
Set the left margin
HP_lmiset( nLmi )
Set the left margin in inches.
HP_lmcmset( nLmCm )
Set the left margin in centimeters.
HP_lpi( nLpi )
Set number of Lines Per Inch. This function sets the internal
VMI setting.
HP_macrocmd( nMacroCmd , nMacroId )
This macro control function lets you define, invoke and delete
macros.
HP_mkshadow( nTop,nLeft,nHeight,nWidth [,nShwdth [,nShfill
[,nShGrayPat [,nShtype]]]])
Draws a shadow around an imaginary box, ignoring the status of
HPshadow().
HP_moverlay( lSw , nMacroId )
Enable or Disable automatic overlay action to a macro.
HP_orient( nOrient )
Sets the print direction with respect to the physical page. You
can use this command only once per page. This command sets the
defaults of page length, text length, margins, VMI, HMI.
HP_pagesize( nPageSize )
Select the page size used for printing. (Letter, legal,
executive, A4)
HP_pitch( nPitch, nStyle, cSymbol )
This function helps you manipulate the Courier font in the
printer, selecting the pitch, style and symbol set.
HP_prdirect( nDir )
Sets the direction of printing. (Works with HP III, PCL 5) this
command will not print the page out like when changing
orientation.
HP_rbox( nHeight, nWidth [,nLineWidth [,nFill [,nGrayPat]]])
Draw a box at the current cursor position.
HP_rcpos( nTop ,nLeft ,lRel )
Set row and column coordinates regardless of HPsizes() status.
HP_rcsay( nRow ,nCol, cStr ,lRel )
This function allows you print at any Row/Column coordinates on
the page ignoring the state of HPsizes().
HP_reset()
Send a reset command to the printer.
HP_rjust()
Right justify a text.
HP_rline( nHeight, nWidth [,nFill [,nGrayPat]] )
Draw lines at the current cursor position. By changing the size
of nHeight and nWidth you can draw Horizontal lines, vertical
lines and rectangles (up to full page size).
HP_rmset( nRm )
Set the right margin.
HP_rmiset( nRmi )
Set the right margin in inches.
HP_rmcmset( nRmCm )
Set the right margin in centimeters.
HP_savecsr(),HP_restcsr()
Push/Pop the current cursor position to/from stack.
HP_scalef( nPoint[,nStyle[,nWgt[,cSymbol[,nTypeFace]]]])
Use scalable fonts.
HP_send( lSend )
HP_send() causes ProHP to switch from sending printer code to
the output device or returning them as HPC (string variable).
HP_setpos( [ nTop ], [ nLeft ], [ lRel ] )
Control the cursor position, absolute and relative positioning.
HP_stmacro( nMacroId )
Call this function as the first step in creating a macro.
HP_sub( cStr )
Prints text in subscript mode.
HP_super( cStr )
Prints text in superscript.
HP_symbol( cSymbol )
Set a symbol set as the default set.
HP_textleng( nTextLength )
Set the number of lines per page before auto eject.
HP_tmset( nTopMargin )
This command designates the number of lines between the top of
the page to the top of the text area.
HP_tmiset( nTMi )
Set top margin in inches.
HP_tmcmset( nTMi )
Set top margin in centimeters.
HP_ulset( lUnderline )
Set underline mode ON or OFF.
HPulstr( cStr )
Underline text.
HP_usefont( nFontId )
Select the font previously downloaded to the printer with
nFontID.
HP_vline( nTop, nLeft, nLength [,nLineWidth [,nFill
Draw vertical line.
HP_vmi( nVmi )
Set Vertical Motion Index to nVmi, This command affects the line
feed, and HP_data(D_LPI) is updated to reflect the new LPI.
HP_vprint( nTop, nLeft, cStr , nInc)
This function takes cStr and prints it vertically starting at
nTop,nLeft stepping down with nInc.
HP_wrap( lWrap )
When end of line wrap is enabled, any text beyond the right
margin will be printed on the next line. If disabled, the text
after the right margin is clipped.
HPbold(nStr)
Make a boldface string. This function will work with any font.
HPccm2i( nCm )
Convert cm to inch. If HPsizes() is set to inches then nCm
converts to inches.
HPci2cm( nInch )
Convert inch size to centimeter if current size used is in
centimeters.
HPcm2col( nCm )
Convert CM to columns.
HPcm2row( nCm )
Convert CM to rows.
HPcol2cm( nCol )
Convert column coordinate to centimeters.
HPcol2i( nCol )
Get the size of nColumns in inches. This function can also
determine the length of any fixed space font if HP_cols(font pitch) is
set.
HPdownload(cFontName [,cLpt [,nFontID [,nSetFont]]])
HPdownload is used for downloading any file in binary mode to
the printer. You can quickly send previously built forms and
letters or any printable file. To send, use HPdownload( cFname ,
cLpt ) where cFname is the file you want to send to the printer,
and cLpt is the output device.
HPdrawmonth( dDate, nTop, nLeft, nHeight, nWidth )
Draws a monthly calendar. The function returns an array with the
coordinates of each day box. Size of calendar from 1" x 1" to a
full page.
HPfonthead( cFontName )
This helps you explore the structure of any soft font.
HPgraytext( nStr [,nFill [,nGrayPat [,nHeight]] )
Print text on gray or pattern background.
HPhfont()
HPhfont is used to determine the cell height of the font. This
function updates each call to HP_pitch() and call to HP_font().
Use this function when you design fine graphics and need to know
the exact height of the font. You can get this information by
reading the font description data array with HPfonthead().
HPi2col( nInch )
Determine the number of columns in nInch.
HPreplicate( cStr , nWidth )
Used to repeatedly print one or more characters in nWidth.
HPsavecsr(), HPrestcsr()
Use this command when you want to save and restore the cursor
location. This function returns HPC regardless of HP_send()
status.
HProw2cm( nRow )
Convert rows to centimeters.
HProw2i( nRow )
Convert rows to inches. Useful when mixing row/col coordinates
and inches.
HPscale( nScale )
This unique function lets you specify the scale factor for the
height and width size in the next drawings. You can match your
output to a different size area without having to recalculate
the new sizes.
HPsetshadow( nShWdth, nShFill ,nShGrayPat ,nShType )
Alternative way to set new defaults for box shadow.
HPshadow( lShadow )
ProHP will do all the calculations to draw a shadow with the
width, filltype ,gray/pattern and position. All you need is to
set HPshadow(.t.).
HPsizes( nMeasure )
Set unit of measure for ProHP functions. Not all functions
accept measures in cm or row/col.
HPstsize( cStr )
Position text anywhere you like. It is easy to justify (center
or right) when you know the text length, especially with
proportional fonts. This function works with all fixed space
fonts (even if you change HMI) and with all soft font downloaded
using HP_font(). Scalable fonts supported with this function are
CGTIMES and UNIVERSE (resident in HP III)
HPwchars( cFont )
ProHP reads the font file with all the necessary data for the
different functions needed to handle it. ProHP reads the chars
width during the process of downloading the font to the printer
when using HP_font().
Set2Print( cDevName )
Set the output device to cDevName. Use this function before
printing.
Set2Screen()
Set the output device to the screen, closing the device opened
previously with set2print(cDevName)
zAddMonth(dDate, nMonths)
Add/ deduct month(s) from a date.
zMdy2Date(nMonth, nDay, nYear)
Create a date using 3 variables (nMonth,nDay,nYear).
****************** HP GL Vector Graphic functions ************************
GL_apento(aXY,lRel)
Plot the points in a XY (array of x,y coordinates) and draw the
line between those points. Typical zig-zag chart.
GL_arc(x,y,nAng,nChordAng,lRel)
Draw an arc specifying angle and center coordinates (relative
or absolute )
GL_Arc3(xInter,yInter,xEnd,yEnd,nChordAng,lRel)
Draw arc using 3 points.
GL_atsay(x,y,cStr,lRel)
Position pen and print text.
GL_box(xCoor,yCoor,lFill)
Draw an outlined or filled rectangle from the current
location to the opposite corner. (absolute coordinates)
GL_circle(R,nChordAng)
Draw a circle using current pen status.
GL_fillchr(nFillType,nEdgePen)
Fill the printed text with hatches, gray shade, or user
defined patterns.
GL_filltype(nFillType,nVal1,nVal2)
Set the active fill type. ( hatches, shading or patterns)
GL_frame(W,H,r,nPw)
Draw a frame with rounded corners.
GL_init()
Reset HP/GL to its defaults.
GL_label(cStr)
Print a label starting at the current pen location.
GL_lineattr(nLineEnds,nLEval,nLineJoins,nLJval)
Set the line attribute.
GL_pen(nPentype,nPenWidth)
Select pen # and pen width for the next drawing.
GL_pendown()
Put pen down for drawing.
GL_pento(x,y,lRel)
Move the pen to a new location. If the pen is down it
will draw the line from the current location to the
new requested location.
GL_penup()
Lift the pen off the paper. ( no printing,
except for the functions that include auto pen down.)
GL_penW(nWidth)
Set pen width.
GL_print(cStr)
Print a text using the current font, direction, path ,
fill type. Starts at the current location.
GL_printdir(nRun,nRise,lRel)
Set the print direction to any desired angle. (360
degrees)
GL_rbox(X,Y,lFill)
Draw an outlined or filled rectangle from the current
location to the opposite corner. (relative coordinates)
GL_rotate(nAngle)
Rotate the coordinate system to any of the following:
0,90,180,270
GL_scale(xSc,ySc)
Set scaling factor for x axis and y axis
GL_scalef(point,style,sw,sym,typeface)
Select any available internal scalable font
GL_setpos(x,y,lRel,lPenD)
Control pen position using absolute or relative
coordinates.
GL_setraster(nIndex,cPattern)
Define a new pattern. (design your own and add it to the
system)
GL_slant(nTang)
Define the slant angle of the next text printed.
GL_symbol(ch)
Set a character to be printed at any coordinate plotted.
GL_textpath(nP,nNl)
Select the text path (Up, Down, Right, Reverse ) in the
current direction status.
GL_transp(l)
Set transparent mode for the next drawing, printing.
GL_wedge(nRadius,nStAng,nSweepAng,nChordAng,lFill)
Draw an outlined or filled wedge.
***************** Additional PCL functions *************************
HP_djust(nTop,nLeft,cStr)
Decimal Justification. (good for columns of numbers)
HP_fjust(nTop,nLeft,cLine,nWidth,lRtrim)
Full justification. (supports every soft font and all
internal fonts including scalables in LaserJet III and 4.)
_hpgetline(cStr,nWidth,cDelim,@nStartAt,aWch)
Process text blocks by getting a line of text that is no
longer than nWidth starting at nStartAt. This is a very fast
function that also returns the correct size of the actual line.
HP_gl(nCsrpos)
Switch to GL mode. You may save the current cursor
position.
HP_hmove(n)
Relative horizontal move.
HP_negative(cStr,nFill,nGrayPat)
Print a text in white characters over a black, gray or
patterned background.
HP_pcl(nCsrpos)
Switch to PCL mode from GL mode.(you may retain current
pen location as current cursor location or restore
cursor status used on entering GL mode.
HP_prmode(nSMode,nPatMode,nGrayPat,nCurFill)
Set the print mode of the printer. This function allows
you to print gray or pattern text or images over any
gray or pattern area or image.
HP_prpcx(cPcxFile,.f.,cLpt)
Print a .PCX image file to the printer or to a file. This
function automaticaly detects and converts 16 and 256
color images to mono for the printer. You may invert the
image or print it as gray shade or pattern using
HP_prmode(), Set the resolution with HP_setres() and the
size of the image with HP_rastW() and HP_rastH(). You
may also save the image into a macro for faster processing
or macro overlay.
HP_pscode(cZip)
Return Postal Service zip bar code. Mail will be
processed faster at lower postage rates.
HP_rastdir(nDir)
Set raster printing direction, to physical page or to
orientation.
HP_rastEND(nMode)
End raster mode.
HP_rastH(nH)
Set how many rows of raster images to print.
HP_rastST(nMode)
Start raster mode.
HP_rastW(nW)
Set number of dots in the raster width to print.
HP_scalef(point,style,sw,sym,typeface)
Enhanced function to support all scalable fonts included in
LaserJet III and 4.
HP_setres(nRes)
Set resolution mode for the next raster image.
_hptoken(cStr,cDelim,nStartAt,aWch)
Process text in tokens. ( Tokens are word sets delimited by
spaces or other characters) You can use this function for any
other token process. (works very fast)
HP_uom(nDpi)
Define units of measure to be used by the printer.
HPfascent()
Get the height of the font from the baseline to the
highest point in the current font.
HPfavgW()
Get average width of the current scalable font.
HPfcapH()
Get the height of the capital letters in the current
font.
HPfdescent()
Get the distance from the baseline to the lower point of
the font.
HPfxheight()
Get the height of the lower x in the current font.
Hpi2cur(n)
Convert inches to the current unit of measure.
HPlcount(cStr1,nWidth,cDelim,nStart)
Count the number of lines of text in a given width using
the current font.
HPtfmerror(v)
Report on error when reading font information from font
data file.
PCXINFO(cPCXfile,aPcx)
Get the information necessary to print a PCX image before
you print it. Resolution, size , number of colors and
more.
PJL_init(cLanguage,cMsg,nRes)
Initialize PJL to default and set language, message,
resolution.
PJL_panelmsg(cMsg,lOffline)
Display a message on the printer panel display with
the option to take the printer off line and wait for the user
to press the on line key.
spccount(cStr)
Returns the number of spaces in a string.
E